home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / gfx / board / cybershow20.readme < prev    next >
Text File  |  1995-07-02  |  19KB  |  431 lines

  1. Short:    Picture viewer (incl.PCD) for CybGfx&AGA
  2. Author:   hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  3. Uploader: hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  4. Type:     gfx/board
  5.  
  6. CyberShow Version 2.0 (c) by Helmut Hoffmann 1995
  7. =========
  8.  
  9. This is an universal shareware picture viewer (incl. PhotoCD) and
  10. converter which can
  11.  
  12. * display images in TrueColor/HighColor in Cybergraphic windows on
  13.   a Workbench with at least 15Bit color depths
  14.  
  15. * display images in reduced color (upto 256 colors) on any WB screen,
  16.   including AGA, ECS, OCS and usually WB-Emu graphic board screens
  17.   as well (e.g. EGS-Emu, Cyber-Emu, ...)
  18.  
  19. New: + now with massively enhanced comfort (scrolling during preloading,
  20.        scrollbars, faster scrolling, keyboard control, menues)
  21.      + now with function to go back to previous pictures as well
  22.      + new functions (picture information window, fast direct transfers)
  23.      + now with optional fast downscaled loading (1:1, 2:1, 4:1, 8:1)
  24.      + now with save functions for many 24Bit formats
  25.  
  26. Supported picture file formats for loading:
  27.  
  28. 1) IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  29. 2) PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit RGB)
  30. 3) JPeg (color and greyscale)
  31. 4) PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  32. 5) QRT (also known as dump format by PD raytracers as POV-Ray)
  33. 6) Targa (RLE compr.&uncompr. 24Bit, 1Bit, 8Bit grey/Colormap; incl. interleaved)
  34. 7) PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  35. 8) BMP (uncompr. formats for 24Bit RGB and 1Bit, 4Bit or 8Bit Colormap)
  36. 9) TIF (packbit-compr./uncompr. Motorola formats 24Bit RGB, 1-8Bit grey/Colormap)
  37. 10) EGS7.x window icons
  38. 11) DEEP (compr.&uncompr. IFF-DEEP 24Bit and 32Bit formats)
  39. 12) YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  40. 13) VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  41. 14) RGB (IFF-RGB: RGB8 and RGBN compressed; RGB5 uncompressed)
  42. 15) HHsYUVSq sequence format (sequential or random access)
  43. 16) IFF-PBM (DPII) format
  44. 17) ACBM (IFF-ACBM: 1 to 8Bit, EHB, HAM6, HAM8)
  45. 18) FBM (8Bit grey/Colormap and 24Bit)
  46. 19) Sun raster (uncompressed formats for 1Bit, 8Bit grey/ColorMap and 24Bit)
  47. 20) MacPaint (b&w compressed 1Bit format; datafork only)
  48. 21) HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  49.  
  50. and all picture and animation DataType formats under OS3.x.
  51.  
  52. For animation formats (HHsYUVSq and animation datatypes) the first frame is shown
  53. (for playback of HHsYUVSq animations you can use my freeware program CyberTVPlayer).
  54.  
  55. Please note: The GIF format is not internally supported for legal reasons, but
  56. due to the DataType support GIF loading should be possible if you have a
  57. suitable DataType (with a fast GIF DataType loading is usually still faster
  58. than with many other viewers which directly support GIF!).
  59.  
  60. Supported picture file formats for saving:
  61.  
  62. 1) IFF-ILBM 24Bit (compressed and uncompressed)
  63. 2) IFF-DEEP 24Bit (uncompressed)
  64.    This format is used e.g. by TVPaint or XiPaint
  65. 3) JPeg (variable compression rates)
  66. 4) PPM-P6
  67.    This format is used by the PBM image processing software
  68. 5) QRT
  69. 6) Targa 24Bit (compressed and uncompressed)
  70. 7) HHsXRL TC24 format (compressed lossless and lossy)
  71.    This format is esp. designed for raytracing pictures, which should be
  72.    compressed lossless or with nearly invisible losses. Compression is usually
  73.    better than IFF-ILBM or Targa compression.
  74.  
  75. Highlights of CyberShow: Why should you use this viewer
  76.  
  77. + All loading functions (except JPeg: This software is based in part on the work
  78.   of the independent JPeg Group) have been written in Assembler and optimised for
  79.   extremely high speed. Loading will usually be upto 5 times faster than with
  80.   comparable viewers... An exception to this is the JPeg format, which is
  81.   written in C and based on the usual code, so that it will be about the same
  82.   speed as other viewers.
  83.  
  84. + Automatic preloading: The next picture is loaded while you view the current
  85.   picture; you can now also scroll the picture or use other functions during
  86.   preloading of the next picture; this reduces waiting time to a minimum
  87.  
  88. + Supports true color viewing on Cybergraphic public screens of at least 15Bit
  89.   color depths
  90.  
  91. + Supports reduced color viewing on screens with 2 to 256 colors, including
  92.   most kind of WB emulations on graphic boards. A special color selection
  93.   scheme is used for good quality and good speed.
  94.  
  95. + Pictures can be scrolled (with cursor keys or scrollbars) in their
  96.   resizeable windows.
  97.  
  98. + Support of nearly all commonly used image formats (incl. PhotoCD) and
  99.   additional DataTypes for even more formats
  100.  
  101. + Can view single files, group of files (specified by a pattern) and
  102.   even directory trees (automatic search of subdirectories).
  103.   Images will be shown in alphabetical order (ordered by complete path name).
  104.  
  105. + Optional downscaled loading for faster access
  106.  
  107. + Can go back to previous images as well
  108.  
  109. + Information window for picture can be opened including name, dimensions,
  110.   file type and number of frames (for animations)
  111.  
  112. + Fast direct transfer of images to famous image processing and painting
  113.   programs (currently ImageFX, XiPaint and ArtEffect/PicoPainter are supported;
  114.   transfers to other programs could be included if more developers/dealers
  115.   would support me)
  116.  
  117. + Save function to convert pictures into some 24Bit file formats (JPeg, IFF, ...)
  118.  
  119. + ...
  120.  
  121. (More to come if enough users register: Possible future expansions e.g.
  122.  + include a slideshow mode with transition effects
  123.  + zooming functions for magnification or downscaling)
  124.  
  125. Using instructions
  126. ==================
  127.  
  128. For start from CLI you can specify a parameter with the picture path
  129. including a pattern or file name (e.g. CyberShow CD1:Photo_CD/Images/#?pcd).
  130.  
  131. For start from Workbench no parameter can currently be selected.
  132. Instead a requester will appear and ask you to select the directory
  133. and (optional) a pattern or file name.
  134.  
  135. In any case subdirectories will be searched automatically if you
  136. don't restrict searching by a pattern to one directory.
  137.  
  138. Default is to load pictures in full size. With the "Scaled-Loading" menue
  139. you can select to load all pictures in 1/2, 1/4 or 1/8 of their original
  140. size. For many file formats this downscaled loading will be significantly
  141. faster. Please note that the pictures will be in small form in memory, thus
  142. save or transfer operations will save or transfer the images in small form.
  143.  
  144. To advance to the next picture use the "Next Picture" menu entry
  145. (Shortcut Amiga N) or press the close button of the picture window.
  146. During displaying the next picture will already be loaded. Since version
  147. 2.0 you can now scroll or resize the window or select another function
  148. while the next picture is preloaded (due to technical restrictions of some
  149. file formats this is partially not available if pictures are not stored
  150. line by line, e.g. FBM24, ACBM, DataTypes, vertical PCD images, YUV, VLB,
  151. HHsYUVSq; during the color conversion phase you can still scroll and this
  152. phase is often longer than the loading time unless you load from floppy disk).
  153. Scrolling can now be performed with cursor keys or the scroll bars.
  154.  
  155. You can also go back to previous pictures with the "Previous Picture"
  156. menu entry (Shortcut Amiga P).
  157.  
  158. For the currently displayed picture you can get an information requester
  159. by selecting the "Picture Info" menu item (Shortcut Amiga I). It includes
  160. the name, dimensions, file format and number of frames (for animations).
  161. The file format string often includes the color depths or other variation
  162. informations as well. For pictures loaded with any DataType, the file
  163. type is "DTxx" with xx being the color depth. For animations loaded with
  164. DataType the file type is "DHxx".
  165.  
  166. You can quit the program with the "Quit" menu item in the picture windows,
  167. by pressing Ctrl-C in the CLI or sending a Ctrl-C signal to the task.
  168.  
  169. The "About" menu function gives an information requester (which includes
  170. the personal registration information if you are a registered user with
  171. a correctly installed keyfile).
  172.  
  173. Fast direct transfer and saving/conversion (not available in demo version):
  174.  
  175. You can directly transfer the image in full 24Bit quality very fast to
  176. important image processing and painting programs (see transfer menu).
  177. Currently supported applications: ImageFX, XiPaint and ArtEffect/PicoPainter
  178.  
  179. Transfers should at least be possible to ImageFX 1.5/1.6, ImageFX 2.x,
  180. EGS-ImageFX, XiPaint 3.x, all versions of ArtEffect and PicoPainter 1.3.
  181. For ArtEffect/PicoPainter you can transfer the image into a picture
  182. project window or into a brush.
  183.  
  184. Please note that pictures will always be transferred in their loaded
  185. size. If you have the downscaled loading selected, the pictures will
  186. be transferred in small form.
  187.  
  188. The same restrictions apply to the save functions which can be used to
  189. convert the currently loaded image into one of several formats (see
  190. above for list of supported save formats). All pictures are saved as
  191. 24Bit images. This is not dependent on the screenmode. The size which
  192. has been used for loading will be the size in which it is saved. For
  193. JPeg saving you can select the quality between 50% and 95% in 5% steps
  194. with a sub menu.
  195.  
  196. Problems with loading specific file formats?
  197.  
  198. If you have difficulties viewing a picture in one of the supported
  199. file formats (or DataTypes) and you are sure that you have enough
  200. memory left, check the following:
  201.  
  202. a) File systems: Some PD/ShareWare/Commercial add-on or replacement
  203.    file systems are buggy (e.g. they do not support some rarely used
  204.    DOS functions properly). Try to copy the picture to a standard
  205.    device (e.g. RAM:) and to view it from there. If this works, you
  206.    know that your specific file system is buggy. I really reccommend
  207.    to only use official Commodore file systems (e.g. the AmigaOS3.1
  208.    CD-Filesystem) in case of difficulties.
  209.  
  210. b) DataTypes: Some DataTypes are instable and can crash on certain
  211.    pictures with odd dimensions or incomplete pictures. I have no
  212.    influence on this.
  213.  
  214. Requirements
  215. ============
  216.  
  217. For usage with Cybergraphics on HiColor/TrueColor screens:
  218.  
  219. - cybergraphics.library V40 or higher
  220.   (Cybergraphics is a Workbench emulation/True color software extension
  221.    which is usable in conjunction with several graphic boards as the
  222.    Cybervision, Piccolo, SD64, Picasso, Retina-BLTZ3, Spectrum. It is
  223.    Copyright by Thomas Sontowski and Frank Mariak.)
  224. - Default Public screen with at least 15Bit color depths
  225. - OS2.04 or higher
  226. - some memory (about 4MByte Fast-RAM should be enough for normal use)
  227.  
  228. For usage on WB screens with 2 to 256 colors:
  229.  
  230. - OS3.1 (esp. graphics.library V40)
  231.   Future versions might also be usable with OS3.0, but currently OS3.1
  232.   is really needed for 2 to 256 color usage
  233. - some memory (about 4MByte Fast-RAM should be enough for normal use)
  234.  
  235. Shareware modalities
  236. ====================
  237.  
  238. The unregistered demo version of CyberShow has an important restriction:
  239.  
  240. All pictures will be shown in greyscale only in the demo version!!!
  241.  
  242. Anyway, I have designed the loading functions so that the speed is the
  243. same as with color loading so that you can check the real speed of my
  244. fast loading functions, but please note: on screens with less than
  245. 15Bit color depths the displaying speed of the greyscale pictures could
  246. be higher than that of color pictures due to the fact that the color pen
  247. allocation is different. I have no influence on this; to see the real
  248. speed, try it on HiColor/TrueColor screens (if you have Cybergraphics),
  249. as no color pens are needed and it makes no difference if a greyscale
  250. or true color image is displayed. If you want to see how the color
  251. allocation works with 2 to 256 colors, take a look at CyberTVPlayer,
  252. my freeware animation player for HHsYUVSq sequences (a sample sequence
  253. is included in the CyberTVPlayer archive). CyberTVPlayer uses the same
  254. color reducing functions as CyberShow.
  255.  
  256. Some other functions are also not available in the demo version (e.g.
  257. fast direct transfer functions and save functions).
  258.  
  259. *** Special offer ***
  260.  
  261. The shareware registration fee is currently only 20DM (in europe)
  262. or 18US$ (outside europe). This offer is at least valid upto 31st July 1995.
  263. I have not yet decided if the shareware fee will be higher at a later time,
  264. but it might become a bit higher (e.g. 30DM / 25US$).
  265.  
  266. Other currencies are possible as well (see registration form for details).
  267.  
  268. To register send the filled in and signed registration form (included
  269. in this archive) to my address together with the money as banknotes,
  270. a cheque or international postal money order:
  271.  
  272. My address:             Helmut Hoffmann
  273.             Rubensstrasse 4
  274.             D-41063 Moenchengladbach
  275.  
  276.             Germany
  277.  
  278. Users in germany can also transfer money to my account (No bank transfers
  279. from outside germany!!).
  280.  
  281. You can currently contact me by EMail (no registrations by EMail!):
  282.  
  283.         hhoff@pool.informatik.rwth-aachen.de
  284.  
  285. After registration you will receive a keyfile and the latest version of
  286. this program. The keyfile will enable you to use future demo versions of
  287. this program as full version. The processing of your order can take
  288. some time. Usually it will be very fast (only a few days), but under raw
  289. circumstances it could take some weeks.
  290.  
  291. Registered users might get another advantage: If I decide to port my
  292. picture management software EGSPhotoAlbum for Cybergraphics and standard
  293. Amigas, registered CyberShow users can register for a lower price.
  294. The fast loading functions of CyberShow are the same as thoose in
  295. EGSPhotoAlbum Professional 5.x.
  296.  
  297. Special note for ImageFX users: In addition to CyberShow you can order
  298. my FastImageFXModules for a small add-on fee. The loader module is based
  299. on the same functions as CyberShow (only JPeg is missing). A saver
  300. module for some formats is also included.
  301.  
  302. Version history
  303. ===============
  304.  
  305. 1.0 (14th june 95): Initial release (supporting 21 file formats and DataTypes)
  306. 2.0 (19th june 95): Added menu for picture windows offering Quit, About, SaveAs,
  307.                      Picture Info, Next/Previous Picture, Transfer, Downscale
  308.                     Added fast direct transfer functions to ImageFX, XiPaint
  309.                      and ArtEffect/PicoPainter
  310.                     Added saving functions (7 formats) for picture conversions
  311.                     Added function to go back to previous pictures
  312.                     Added scrollbars for comfortable scrolling
  313.                     Implemented faster scrolling methods
  314.                     Functions like scrolling/resizing now already usable
  315.                      during the next picture is loaded
  316.                     Window position will now be left unchanged for newly
  317.                      opened windows if possible; the scroll position will
  318.                      be left unchanged between pictures of identical size
  319.                     Information requesters for unreadable pictures/problems
  320.                     Preloading is suppressed if not enough memory is available
  321.                     Support of downscaled loading (1:1, 2:1, 4:1, 8:1)
  322.  
  323. Special Thanks
  324. ==============
  325.  
  326. My special thanks go to:
  327.  
  328.  Kermit Woodall from NOVA-Design for providing me with ImageFX-EGS.
  329.  Thomas Dorn for providing me with "EGS-XiPaint beta".
  330.  Alexander Pratsch for providing me with ArtEffect (successor of PicoPainter).
  331.  Without this support the fast direct transfer functions would
  332.   probably have been impossible.
  333.  Thomas Sontowski and Frank Mariak for making the TrueColor/HighColor
  334.   Workbench possible.
  335.  The "Independent JPEG Group" for providing the portable C source code
  336.   for JPeg compression/decompression. The JPeg functions are based on
  337.   this code (This software is based in part on the work of the independent
  338.   JPeg Group).
  339.  
  340. Hard- and Software used for developing
  341. ======================================
  342.  
  343. This program is written in pure Assembler (using the german assembler
  344. O.M.A. 2.0). Only the lowlevel JPeg functions have been implemented
  345. in C (based on the portable C source of the Independent JPeg Group)
  346. and compiled with the german MaxonC++ 3.0 system.
  347.  
  348. My development system is:
  349.  
  350. Amiga 3000/030/25MHz / 18 Megabytes RAM / OS3.1
  351.  
  352. 4MByte Piccolo SD64 (64Bit) graphics board (running in Zorro III-mode).
  353.  
  354. This program was tested with enforcer and mungwall running.
  355.  
  356. Disclaimer
  357. ==========
  358.  
  359. This software (program and documentation) is provided "as is" and
  360. comes with no warranty, either expressed or implied.
  361. The author is in no way responsible for any damage or loss that may
  362. occur due to direct or indirect usage of this software. You use
  363. this software entirely at your own risk.
  364.  
  365. Copyright
  366. =========
  367.  
  368. This software (program and documentation) is copyright by
  369.  
  370.                         Helmut Hoffmann
  371.             Rubensstrasse 4
  372.             D-41063 Mönchengladbach
  373.  
  374.             Germany
  375.  
  376. The demo version may be freely distributed and used as
  377. long as the following conditions are met:
  378.  
  379. 1) All files have to be kept together
  380.  
  381. 2) No file may be modified or crunched/packed.
  382.  
  383.    The only official way to distribute this demo packed is the
  384.    original .lha archive.
  385.  
  386.    The program may not be disassembled or analysed. The limitations
  387.    integrated in the demo version may under no circumstance be removed
  388.    or bypassed.
  389.  
  390. 3) Distributors may only charge for the duplication process (including media)
  391.    and not for the software. Theese charges may not exceed the following
  392.    limits: a) Demo on a PD-disk: 8$ (US-dollar) including
  393.               postage&packing (in Germany: 12DM)
  394.        b) Demo on a PD-CD-ROM: 50$ (US-dollar) including
  395.               postage&packing (in Germany: 75DM)
  396.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  397.               callable system: Maximum charge 4$ (US-dollar) (in Germany: 6DM)
  398.               for downloading
  399.    Anyway, it must be made explictly clear to the buyer, that he does not
  400.    pay for the program (demo) itself but only for the duplication service.
  401.  
  402. 4) It is not allowed to distribute the demo with any commercial product
  403.    without a written permission by me. One exception is the distribution of
  404.    the demo version with products not exceeding the above price limits (e.g.
  405.    a cover-disk magazine for 8$ or less).
  406.  
  407.    The following companies have my explicit permission to distribute the
  408.    demo with their products: NOVA Design, Ingenieurbüro Helfrich.
  409.  
  410.    If you want to distribute the demo with your commercial product
  411.    (hardware or software) write to me for details.
  412.  
  413. 5) The registered version (the keyfile) may not be redistributed. It may only
  414.    run on one machine per registration. It is allowed to make a backup copy
  415.    of the original disk.
  416.  
  417.  
  418. ============================= Archive contents =============================
  419.  
  420. Original  Packed Ratio    Date     Time    Name
  421. -------- ------- ----- --------- --------  -------------
  422.      628     259 58.7% 19-Jun-95 00:51:20  CyberShow.info
  423.   119400   56942 52.3% 19-Jun-95 11:57:54 +cybershow
  424.      454     282 37.8% 14-Jun-95 16:46:30 +CyberShow.info
  425.    18346    7230 60.5% 19-Jun-95 12:04:06 +CyberShow.ReadMe
  426.      477     248 48.0% 14-Jun-95 16:46:30 +CyberShow.ReadMe.info
  427.     2743    1139 58.4% 18-Jun-95 03:23:48 +Registration.txt
  428.      477     249 47.7% 14-Jun-95 16:48:54 +Registration.txt.info
  429. -------- ------- ----- --------- --------
  430.   142525   66349 53.4% 21-Jun-95 23:52:12   7 files
  431.